Microsoft DirectX 8.1 (C++)

IMediaDet::EnterBitmapGrabMode

The EnterBitmapGrabMode method switches the media detector to bitmap grab mode and seeks the filter graph to a specified time.

Syntax

HRESULT EnterBitmapGrabMode(
    double StreamTime
);

Parameters

StreamTime

Time, in seconds, to which the graph seeks.

Return Value

Returns an HRESULT value. Possible values include the following:

Value Description
S_OK Success.
E_INVALIDARG Invalid argument.
VFW_E_INVALIDMEDIATYPE File does not have a video stream.
VFW_E_TIME_EXPIRED Could not seek.

Remarks

Before calling this method, set the file name and stream by calling IMediaDet::put_Filename and IMediaDet::put_CurrentStream.

This method inserts the Sample Grabber filter into the filter graph. You can then call IMediaDet::GetSampleGrabber to obtain a pointer to the ISampleGrabber interface. Once the media detector enters bitmap grab mode, the various informational methods in IMediaDet do not work.

The IMediaDet::GetBitmapBits or IMediaDet::WriteBitmapBits methods also put the media detector into bitmap grab mode.

See Also